home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / mhs / ngm138.exe / RELNOTE.TXT < prev   
Text File  |  1993-03-31  |  13KB  |  368 lines
  1. SNADS for NetWare Global MHS v1.0 revB
  2. Release Note
  3.  
  4. The name of this product was changed from NetWare Global
  5. Messaging SNADS Protocol Module to SNADS for NetWare Global
  6. MHS after the product documentation was printed.  The product
  7. name has not yet been changed in the documentation.
  8.  
  9. This release note lists enchanced features and provides
  10. documentation corrections, trouble-shooting hints and other
  11. information of which you need to be aware.
  12.  
  13.  
  14. Features
  15. ========
  16.  
  17. The SNADS protocol module provides the following features:
  18.  
  19.         *       Transfers messages between NetWare Global MHS and
  20.                 SNADS endpoints using an existing SNA network.
  21.  
  22.         *       Provides support for the SNA communications protocols.
  23.  
  24.         *       Supports connections via direct token ring or SDLC to an
  25.                 SNA wide area network.
  26.  
  27.         *       Supports one or more LU6.2 sessions and up to two PU2.0 or
  28.                 2.1 connections.
  29.  
  30.         *       Supports automatic directory synchronization between
  31.                 DISOSS and NetWare Global MHS.
  32.  
  33.         *       Supports SMF extended addresses.
  34.  
  35.  
  36. Extended Address Support
  37. ========================
  38.  
  39. A new feature in SNADS for NetWare Global MHS allows SNADS
  40. users to include SMF extended addresses in messages sent to
  41. NetWare Global MHS. Because SNADS users can now include
  42. address extensions in their messages, the Global MHS server
  43. administrator no longer needs to define users with extended
  44. addresses in the SNADS Auto-Registration Table.
  45.  
  46. Some environments, such as fax and X.400, require special address
  47. information. To support these environments, the SMF protocol
  48. contains an extended address field. For example, to send a message
  49. to Sharon Carstairs through a fax gateway, a NetWare Global MHS
  50. user would address the message to Sharon Carstairs@FaxGate
  51. {Fax:1-555-1234/Sharon Carstairs}.
  52.  
  53. However, SNADS does not support extended addresses. To enable
  54. SNADS users to send to these environments, the SNADS protocol
  55. module allows SNADS users to include extended addresses in their
  56. messages.
  57.  
  58. SNADS users can enter extended addresses in one (and only one) of
  59. the following three locations: at the beginning of the message; in
  60. the subject; or at the beginning of the document. The SNADS
  61. protocol module scans these three locations in the order in which
  62. they are listed. If it finds an extended address in one of these
  63. locations, it will ignore any extended addresses in the others.
  64.  
  65. An extended address definition begins with two open angle brackets
  66. (<<) and ends with two closed angle brackets (>>). Between the
  67. beginning and ending markers are one or more address extensions,
  68. separated by one or more spaces. Thus, the syntax of the extended
  69. address definition is as follows:
  70.  
  71.        <<extension definition(s)>>
  72.  
  73. Each extension definition has one of the following formats:
  74.  
  75.        dgn.den={extended address}
  76.  
  77.        dgn.den=(extended address)
  78.  
  79.        dgn.den="extended address"
  80.  
  81. where dgn.den is a recipient specified in the message address. The
  82. extended address can be enclosed in braces, parentheses, or double
  83. quotation marks.
  84.  
  85. If a message has only one recipient, the dgn.den= can be omitted
  86. from the extended address definition.
  87.  
  88. For example,  Pam Pratt is a SNADS user who wants to send a
  89. message to Sharon Carstairs. Messages for Sharon are routed
  90. through NetWare Global MHS to a fax gateway. Pam creates a
  91. message and addresses it to FAXGATE.SCARSTAI. At the beginning
  92. of the subject field, she enters:
  93.  
  94.        <<{Fax:1-555-1234/Sharon Carstairs}>>
  95.  
  96. Because the message is addressed to only one user, Pam does not
  97. include the dgn.den=.
  98.  
  99. Consider a second example. Pam Pratt wants to send a message to
  100. Sharon Carstairs and Donna White, an X.400 user. Messages for
  101. Donna are routed through NetWare Global MHS to an X.400
  102. Gateway. Pam creates a message and addresses it to
  103. FAXGATE.SCARSTAI and X400GATE.DWHITE. At the beginning of
  104. the message, she enters:
  105.  
  106. <<
  107.  
  108. FAXGATE.SCARSTAI={Fax:1-555-1234/Sharon Carstairs}
  109.  
  110. X400GATE.DWHITE={X400:C=US;A=Publicmail;P=ABC;O=ABC;
  111. G=Donna;S=White}
  112.  
  113. >>
  114.  
  115. Because the message is addressed to more than one user, Pam must
  116. include the dgn.den=.
  117.  
  118.  
  119. SNADS Protocol Module Training
  120. ==============================
  121.  
  122. Self-paced study course #1760, titled Administering SNADS for
  123. NetWare Global MHS, is available. NetWare Global MHS training
  124. course #750 provides comprehensive instruction in installation,
  125. configuration, and administration of the NetWare Global MHS
  126. software.
  127.  
  128. For more information about either of these training courses, call
  129. (800) 233-3382 or (801) 429-5508, or contact your local Novell
  130. authorized education center.
  131.  
  132. Contacting Novell Messaging Technical Support
  133.  
  134. Should you need technical support for NetWare Global MHS,
  135. contact your Novell reseller, or Novell at (800) NETWARE or (801)
  136. 429-5588.
  137.  
  138.  
  139. Documentation Corrections
  140. =========================
  141.  
  142. The table below lists corrections for the NetWare Global Messaging
  143. SNADS Protocol Module Administrator's Guide.
  144.  
  145. p. 6-2, Step 3b
  146.  
  147. If a user's address includes an extended address
  148. (for example, if the user is an X.400 user), you
  149. must:
  150.  
  151. *       Include the extended address when you
  152.         enter the user's NGM name.
  153.  
  154. *       Define the user in the Auto-Registration
  155.         table (see Chapter 5 for detailed
  156.         instructions). The NGM name in the
  157.         Auto-Registration table must also include
  158.         the extended address.
  159.  
  160. p. 7-8, no. 4
  161.  
  162. Add the following after no. 4:
  163.  
  164. 4a.     Define your server's directory
  165.         synchronization user (NME-CMP-) in the
  166.         SNADS Auto-Registration table. This step is
  167.         necessary because, in NetWare Global
  168.         MHS, the address of an NME-CMP- user
  169.         does not contain a workgroup element.
  170.         (Messages for NME-CMP- users are
  171.         addressed to NME-CMP-@server.)
  172.         However, DISOSS requires that every user
  173.         address contain a workgroup element.
  174.  
  175. p. 7-8, no. 5
  176.  
  177. After configuring DISOSS and NetWare Global
  178. MHS for directory synchronization, you MUST
  179. force a full directory reconciliation to initiate
  180. the directory synchronization feature.
  181.  
  182. p. 7-12, Step 7
  183.  
  184. Change the Directory Sync Address for the
  185. DISOSS node to NME-CMP-@<workgroup>,
  186. where <workgroup> is the workgroup name for
  187. the DGN to which the DISOSS NME-CMP-
  188. user belongs. Ensure that this workgroup's
  189. SNADS alias is its DGN.
  190.  
  191. p. 7-13
  192.  
  193. Before forcing a full directory reconciliation,
  194. add your server's NME-CMP- user to the
  195. SNADS auto-registration table. Refer to page
  196. 5-2 for detailed instructions. The user's NGM
  197. name must be NME-CMP-@<server> (where
  198. <server> is the name of your server). The user's
  199. SNADS DUN must be <dgn>.NME-CMP- (where
  200. the <dgn> is the same as the SNADS REN
  201. assigned to your server).
  202.  
  203. p. 7-13
  204.  
  205. You MUST force a full directory reconciliation
  206. to initiate the directory synchronization
  207. feature.
  208.  
  209. p. 7-29
  210.  
  211. The DDN for a remote directory
  212. synchronization user must be the same as the
  213. user's REN. In the example entry, the DDN and
  214. REN should both be "LA."
  215.  
  216. p. 7-34
  217.  
  218. Note: If a new update is generated when the
  219. Directory Parcels Status list contains 40 unsent
  220. updates, the oldest update in the list is deleted.
  221.  
  222. p. 8-4, Step 1f,
  223. p. 8-9, Step 1f, p. C-4
  224.  
  225. SNADS.NEW is located in <ngmfiles>/SNADS.
  226.  
  227. p. 8-5, Step 2d,
  228. p 8-10, Step 2d, p. C-2
  229.  
  230. The NGMSNADS log is located in <ngmfiles>/LOG.
  231.  
  232. p. B-4
  233.  
  234. Add the following to the list of [NGMSNADS]
  235. parameters:
  236.  
  237.        Maximum-Recipients=<nnn>
  238.  
  239. (Optional) If the maximum number of
  240. recipients for which your SNADS node is
  241. configured is less than 256 (the default), use
  242. this parameter. The SNADS protocol module
  243. will split a message addressed to more than
  244. <nnn> recipients into multiple messages.
  245.  
  246.  
  247. Troubleshooting Hints
  248. =====================
  249.  
  250. For detailed troubleshooting instructions, refer to Chapter 8 of the
  251. NetWare Global Messaging SNADS Protocol Module Administrator's
  252. Guide. Following are suggestions for troubleshooting common problems.
  253.  
  254. Problem:
  255. The SNADS protocol module is rejecting messages being sent to SNADS endpoints.
  256.  
  257. Action:
  258. This error occurs if you are using a limited-user version of the SNADS
  259. protocol module. The sender is not defined as an authorized user.
  260. Add the user to the list of authorized users, following the instructions
  261. in Chapter 6 of the guide.
  262.  
  263. Problem:
  264. Messages from SNADS are remaining in the NGM queue, with the following
  265. workgroup name:
  266.      -unauthorized-.workgroup
  267.  
  268. Action:
  269. This error occurs if you are using a limited-user version of the SNADS
  270. protocol module. The NetWare Global MHS recipient is not defined as
  271. an authorized user. Add the user to the list of authorized users,
  272. following the instructions in Chapter 6 of the guide.
  273.  
  274. Problem:
  275. The SNADS node is rejecting messages received from the SNADS protocol module.
  276.  
  277. Action:
  278. Check the maximum number of recipients for which your SNADS node is
  279. configured. If it is less than 256, add the following parameter to
  280. the [NGMSNADS] section of your server's NGM.CFG file:
  281.  
  282.      Maximum-Recipients=<nnn>
  283.  
  284. where <nnn> is the maximum number of recipients your SNADS node will
  285. accept. For more information about NGM.CFG, refer to Appendix B of the guide.
  286.  
  287. Problem:
  288. Directory information received from DISOSS is not being integrated
  289. into the Global MHS database.
  290.  
  291. Action:
  292. Ensure that your Global MHS server subscribes to the DISOSS workgroups.
  293. For more information, refer to Chapter 7 of the guide.
  294.  
  295.  
  296. General Information
  297. ===================
  298.  
  299. This section provides additional information about the SNADS
  300. protocol module.
  301.  
  302.         *       If a session terminates while the SNADS protocol module is
  303.                 delivering a message to SNADS, the SNADS protocol module
  304.                 will resend the message during the next session. If the
  305.                 message was delivered successfully before the termination
  306.                 occurred, two copies of the message might be delivered to the
  307.                 SNADS recipient.
  308.  
  309.         *       When a DISOSS user sends a message to a NetWare Global
  310.                 MHS distribution list, DISOSS receives a DIA status (delivery
  311.                 report) from each of the list members. Since the list member
  312.                 names do not match the original recipient name (the
  313.                 distribution list), the message status is not updated.
  314.  
  315.                 For example, a DISOSS user sends a message to a NetWare
  316.                 Global MHS list called "Managers." NetWare Global MHS
  317.                 distributes the message to John Smith and Mary Adams, the
  318.                 list members. DISOSS receives DIA statuses from John and
  319.                 Mary, but it does not receive one from "Managers," the
  320.                 original recipient. Therefore, it does not update the message
  321.                 status.
  322.  
  323.         *       SMF short names can only include letters, numbers, and the
  324.                 following special characters: #, $, and -. To ensure
  325.                 compatibility between SNADS and NetWare Global MHS, do
  326.                 not use unsupported characters (such as spaces) in SNADS
  327.                 names.
  328.  
  329.         *       If you are using DISOSS Directory Synchronization,
  330.                 workgroups in your organization must not include both
  331.                 DISOSS and NetWare Global MHS users.
  332.  
  333.  
  334. Copyright 1993 Novell, Inc. All rights reserved. No part of this
  335. publication may be reproduced, photocopied, stored on a retrieval system,
  336. or transmitted without the express written consent of the publisher.
  337.  
  338.                     Novell, Inc.
  339.                     2180 Fortune Drive
  340.                     San Jose, CA 95131
  341.                     U.S.A.
  342.  
  343. Disclaimer
  344. ==========
  345. Novell, Inc. makes no representations or warranties with respect to the
  346. contents or use of this manual, and specifically disclaims any express or
  347. implied warranties of merchantability or fitness for any particular purpose.
  348. Further, Novell, Inc. reserves the right to revise this publication and to
  349. make changes to its content, at any time, without obligation to notify any
  350. person or entity of such revisions or changes.
  351.  
  352. Further, Novell, Inc. makes no representations or warranties with respect
  353. to any NetWare software, and specifically disclaims any express or implied
  354. warranties of merchantability or fitness for any particular purpose. Further,
  355. Novell, Inc. reserves the right to make changes to any and all parts of
  356. NetWare software, at any time, without any obligation to notify any
  357. person or entity of such changes.
  358.  
  359. Trademarks
  360. ==========
  361. NetWare and Novell are registered trademarks and NetWare MHS,
  362. NetWare Global MHS, NGM, and SNADS for NetWare Global MHS are
  363. trademarks of Novell, Inc. NetWire is a service mark of Novell, Inc.
  364.  
  365. SNADS for NetWare Global MHS v1.0 Release Note
  366. January 1993
  367. Novell Part Number 123-000244-002
  368.